home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 3 / Amiga Tools 3.iso / programming / jpegv6 / doc / jpegtran.man < prev    next >
Text File  |  1995-09-05  |  6KB  |  199 lines
  1.  
  2.  
  3.  
  4. JPEGTRAN(1)                                           JPEGTRAN(1)
  5.  
  6.  
  7. NAME
  8.        jpegtran - lossless transcoding of JPEG files
  9.  
  10. SYNOPSIS
  11.        jpegtran [ options ] [ filename ]
  12.  
  13.  
  14. DESCRIPTION
  15.        jpegtran translates JPEG files from one variant of JPEG to
  16.        another, for example from  baseline  JPEG  to  progressive
  17.        JPEG.   The  transformation is lossless: no image degrada­
  18.        tion occurs, which would not be true  if  you  used  djpeg
  19.        followed  by  cjpeg.   However, you cannot alter the image
  20.        quality, because that would not be a  lossless  operation.
  21.        jpegtran  reads  the named JPEG/JFIF file, or the standard
  22.        input if no file is named, and produces a  JPEG/JFIF  file
  23.        on the standard output.
  24.  
  25. OPTIONS
  26.        jpegtran  accepts  a  subset of the switches recognized by
  27.        cjpeg.  If you specify no switches, you get a plain  base­
  28.        line JPEG output file.
  29.  
  30.        All  switch  names may be abbreviated; for example, -opti­
  31.        mize may be written -opt or -o.  Upper and lower case  are
  32.        equivalent.   British  spellings  are also accepted (e.g.,
  33.        -optimise), though for brevity  these  are  not  mentioned
  34.        below.
  35.  
  36.        The basic switches are:
  37.  
  38.        -optimize
  39.               Perform  optimization  of  entropy encoding parame­
  40.               ters.  Without this,  default  encoding  parameters
  41.               are  used.  -optimize usually makes the JPEG file a
  42.               little smaller, but at the price of slower compres­
  43.               sion.  Note that -progressive implies -optimize.
  44.  
  45.        -progressive
  46.               Create progressive JPEG file (see below).
  47.  
  48.        The -progressive switch creates a "progressive JPEG" file.
  49.        In this type of JPEG file, the data is stored in  multiple
  50.        scans  of increasing quality.  If the file is being trans­
  51.        mitted over a slow communications link,  the  decoder  can
  52.        use  the  first  scan  to display a low-quality image very
  53.        quickly, and can then improve the display with each subse­
  54.        quent  scan.   The  final image is exactly equivalent to a
  55.        standard JPEG file of the same quality  setting,  and  the
  56.        total  file  size  is  about  the  same --- often a little
  57.        smaller.  Caution: progressive  JPEG  is  not  yet  widely
  58.        implemented,  so  many  decoders  will be unable to view a
  59.        progressive JPEG file at all.
  60.  
  61.  
  62.  
  63.  
  64.                            15 June 1995                         1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. JPEGTRAN(1)                                           JPEGTRAN(1)
  71.  
  72.  
  73.        Switches for advanced users:
  74.  
  75.        -restart N
  76.               Emit a JPEG restart marker every  N  MCU  rows,  or
  77.               every  N  MCU blocks if "B" is attached to the num­
  78.               ber.  -restart 0 (the  default)  means  no  restart
  79.               markers.
  80.  
  81.        -maxmemory N
  82.               Set limit for amount of memory to use in processing
  83.               large images.  Value is in thousands of  bytes,  or
  84.               millions of bytes if "M" is attached to the number.
  85.               For example, -max 4m  selects  4000000  bytes.   If
  86.               more space is needed, temporary files will be used.
  87.  
  88.        -outfile name
  89.               Send output image to the named file, not  to  stan­
  90.               dard output.
  91.  
  92.        -verbose
  93.               Enable debug printout.  More -v's give more output.
  94.               Also, version information is printed at startup.
  95.  
  96.        -debug Same as -verbose.
  97.  
  98.        The -restart option inserts extra  markers  that  allow  a
  99.        JPEG  decoder to resynchronize after a transmission error.
  100.        Without restart markers, any damage to a  compressed  file
  101.        will usually ruin the image from the point of the error to
  102.        the end of the image; with restart markers, the damage  is
  103.        usually  confined  to  the  portion of the image up to the
  104.        next restart  marker.   Of  course,  the  restart  markers
  105.        occupy  extra  space.   We recommend -restart 1 for images
  106.        that will be transmitted across unreliable  networks  such
  107.        as Usenet.
  108.  
  109.        Switches for wizards:
  110.  
  111.        -scans file
  112.               Use  the  scan  script  given in the specified text
  113.               file.
  114.  
  115.        The "wizard" switches  are  intended  for  experimentation
  116.        with  JPEG.   If  you don't know what you are doing, don't
  117.        use them.  These switches are documented  further  in  the
  118.        file wizard.doc.
  119.  
  120. EXAMPLES
  121.        This  example converts a baseline JPEG file to progressive
  122.        form:
  123.  
  124.               jpegtran -progressive foo.jpg > fooprog.jpg
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                            15 June 1995                         2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. JPEGTRAN(1)                                           JPEGTRAN(1)
  137.  
  138.  
  139. ENVIRONMENT
  140.        JPEGMEM
  141.               If this environment variable is set, its  value  is
  142.               the  default  memory limit.  The value is specified
  143.               as described for the  -maxmemory  switch.   JPEGMEM
  144.               overrides the default value specified when the pro­
  145.               gram was compiled, and itself is overridden  by  an
  146.               explicit -maxmemory.
  147.  
  148. SEE ALSO
  149.        cjpeg(1), djpeg(1), rdjpgcom(1), wrjpgcom(1)
  150.        Wallace,  Gregory  K.  "The JPEG Still Picture Compression
  151.        Standard", Communications of the ACM, April 1991 (vol. 34,
  152.        no. 4), pp. 30-44.
  153.  
  154. AUTHOR
  155.        Independent JPEG Group
  156.  
  157. BUGS
  158.        Arithmetic coding is not supported for legal reasons.
  159.  
  160.        Still not as fast as we'd like.
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.                            15 June 1995                         3
  197.  
  198.  
  199.